
	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	e-docs \| Site Map \| Search \| Contact \| Glossary \| WebLogic Server Documentation

Installing jdbcKona/Sybase

This document tells you how to install the shared library or dynamic link library for jdbcKona/Sybase.

This driver is deprecated

The jdbcKona/Sybase type 2 JDBC driver is deprecated. Deprecated features remain for backwards compatibility only but are slated for removal from the WebLogic Server in the near future. They exist only for WebLogic Server deployments that have not yet migrated to other solutions. Specifically, this driver has not been and will not be updated to match the latest DMBS features or platform developments nor has it been updated to run under a JDK 1.2 environment. While this driver may work in many customer situations, some customers have had problems.

If you wish to acquire a driver to connect to a Sybase installation, you should install the jConnect driver available for free from Sybase.

Install the .dll or .so on your system

The UNIX shared libraries are in the distribution kit in the directory weblogic/lib. The Windows .dlls are included in the distribution kit in the directory weblogic\bin. If you are using Microsoft SDK for Java as your JVM

with jdbcKona/Sybase, please see Notes for Microsoft SDK for Java users.

Distribution

Here are detailed instructions for installing on each platform.

Windows NT/95

Add the distribution directory
weblogic\bin
to your PATH

Distribution

Or copy weblogicsyb26.dll
into java\bin.

If you are using Symantec Cafe or other debuggers, also:

Copy weblogicsyb26.dll and weblogicsyb26_g.dll
into cafe\bin and cafe\java\bin, or into the appropriate directory for your IDE.

The .dll with the _g has been linked with javai_g.dll for better compatibility with debuggers like Cafe's. You should copy both .dlls (for example, weblogicsyb26_g.dll and weblogicsyb26.dll) into cafe\bin and cafe\java\bin.

UNIX

Add the distribution directory
weblogic/lib/{arch}
to your LD_LIBRARY_PATH

Distribution

Or copy the .so files from this directory
into java/lib/{arch}/green_threads/

If you are using a debugger, make a copy of the .so and name it libweblogicsyb26_g.so.

Notes for UNIX users

We suggest that you add the weblogic/lib directory to your LD_LIBRARY_PATH, or copy the file(s) to ~java/lib/{arch}, or the comparable directory suggested in the instructions above.

Copy shared objects (the .so file) for jdbcKona/* products into java/lib/{arch}/green_threads or ~java/lib/{arch}/native_threads, according to your platform.

Notes for Microsoft SDK for Java users

If you are using Microsoft SDK for Java with jdbcKona/Oracle, you will need install a different .dll for the jdbcKona/Oracle driver and use SDK version 3.1 or greater. You will also need to install a separate .dll to work with your debugger.

Microsoft SDK for Java

Add the distribution directory
weblogic\bin
to your PATH

Distribution

Or copy weblogicmssyb26.dll
into c:\winnt or c:\windows.

If you are using Symantec Cafe or other debuggers, also:

Copy weblogicmssyb26.dll and weblogicmssyb26_g.dll
into cafe\bin
and into c:\winnt or c:\windows or into the appropriate directory for your IDE.

The .dll with the _g has been linked with javai_g.dll for better compatibility with debuggers like Cafe's. You should copy both .dlls (for example, weblogicmssyb26_g.dll and weblogicmssyb.dll) into cafe\bin and cafe\java\bin.

Check your connection to the database

The WebLogic distribution includes a Java application to help you in setting up jdbcKona. To use this helper app:

Make sure that the WebLogic distribution is in a directory in your CLASSPATH.

At the command line, type the following:

  $ java utils.dbping SYBASE user password db

For more detailed instructions on how to verify your connection to a DBMS, see Testing connections.

More resources

Documentation

API reference
Using the jdbcKona family of JDBC drivers
Developers Guide Using jdbcKona/Sybase and jdbcKona/MSSQLServer

Applet programming

If you are planning to use JDBC in an applet

, you will need to refer to the Developers Guide Using WebLogic JDBC. Because of browser limitations with native methods

, you can't use jdbcKona/Sybase in an applet.

Code examples

We also ship a number of code examples in the distribution that will help you get started. Code examples are located in the weblogic/examples/ directory in the distribution. Particularly, check weblogic/examples/jdbc/sybase for examples of simple jdbcKona/Sybase applications.

Distribution

Back to the WebLogic installation instructions